Insert RSS Feed

Inserts a number of news items from a RSS source. There are security issues with this component, see the Remarks section for details!

Component properties
Category	AS Miscellaneous
Version	1.0
Complies with Xhtml 1.0 / 1.1 rules	Yes
Supported server programming languages	C# Visual Basic.NET
Output content type	block

When to use

This component is typically used to display a list of items from an RSS source.

Insert RSS Feed

Version:

1.0

Description:

Inserts a number of news items from a RSS source

Server language:

c#|vb

Url:

variable name

The URL of the RSS source file. Supported versions are RSS 1.0 with the RDF syntax and version 0.91 and 2.0.

XSL formatting stylesheet:

Variable namne

This parameter can be a URL or a CS path to an XSLT stylesheet that can be used to supply your own formatting to the output. Leave this field blank to use the standard built in formatting.

Number of items:

The number of newsitems to display. 0 = all items in the specified source

Caching control

Use application cache

Cache the xml query using application variables. Should not be used in an intranet with security permissions set for the rss source.

Cache application name:

variable name

A unique name that specifies this component. This name is used to store cached data and MUST be unique within the website.

Application cache timeout:

Timeout in minutes for application cache, 0 = no timeout

Built-in formatting options. (All parameters below will be ignored if an XSLT stylesheet has been specified.)

Row1:

Choose nodetype to display on this row. If news item does not contain specified nodetype, this row will be excluded from presentation

Row 1 is link

Should this row be used as a link to the newsitem URLs specified in the RSS?

Class 1:

Sets a value that defines a CSS class name to be used with the first row displayed for each news item.

Row2:

Choose nodetype to display on this row. If news item does not contain specified nodetype, this row will be excluded from presentation

Row 2 is link

Should this row be used as a link to the newsitem URLs specified in the RSS?

Class 2:

Sets a value that defines a CSS class name to be used with the second row displayed for each news item.

Row3:

Choose nodetype to display on this row. If news item does not contain specified nodetype, this row will be excluded from presentation

Row 3 is link

Should this row be used as a link to the newsitem URLs specified in the RSS?

Class 3:

Sets a value that defines a CSS class name to be used with the third row displayed for each news item.

Date formatting string:

variable name

Sets a value that indicates how datetime values should be formatted. For a more information on the different date format strings see the DateTimeFormatInfo class documentation. The default value is an empty string which displays the system's date time format.

Size of alternate title.:

Indicates the size of an alternative title when the source does not supply a title. The alternative title is automatically constructed from the first N characters of the description followed by ... For example: setting this property to 25 constucts an alternative title that consists of the first 25 characters in the description. The default value is zero which means that no alternative title is used.

Row colour 1:

The background colour for each un-even row in the generated html table. This is set as a style attribute on the row element and can be overridden by CSS styling that applies directly to the cell.

Row colour 2:

The background colour for each even row in the generated html table. This is set as a style attribute on the row element and can be overridden by CSS styling that applies directly to the cell.

Extra line feed

Insert an extra space between each displayed news item.

Use secure html formatting

Indicates whether the displayed result should be Html encoded or not.
WARNING!
This property should always be checked unless you really need otherwise and the source is highly trusted. Turning off this functionality can cause security problems with Html injections if the source contains active content.

Table formatting options

Table width:

variable name

The width of the generated table. This value can be in percent (ex. 100%) or in pixels (ex. 340).

Table border size:

Border or the generated table. Zero to omit the border.

Cell padding:

The cell padding value (in pixels) used in the generated html table.

Cell spacing:

The cell spacing value (in pixels) used in the generated html table.

Table summary:

variable name

Sets the summary attribute of the generated table. A table summary is recommended for accessibility reasons and omitting this attribute causes xhtml 1.0 strict or higher validators to generate warning.

Table caption:

variable name

Sets the caption element connected to the generated table. A table caption is recommended for accessibility reasons and omitting this element causes xhtml 1.0 strict or higher validators to generate warning.

Insert RSS Feed: programming interface

Url: The URL of the RSS source file. Supported versions are RSS 1.0 with the RDF syntax and version 0.91 and 2.0.
XSL formatting stylesheet: This parameter can be an URL or a CS path to an XSLT stylesheet that can be used to supply your own formatting to the output. Leave this field blank to use the standard built in formatting.
Number of items: The number of newsitems to display. 0 = all items in the specified source
Caching control
Use application cache: Cache the RSS feed.
Cache application name: A unique name that specifies this component. This name is used to store cached data and MUST be unique within the website.
Application cache timeout: Timeout in minutes for application cache, 0 = no timeout
Built-in formatting options. (All parameters below will be ignored if an XSLT stylesheet has been specified.)
Row1: Choose nodetype to display on this row. If news item does not contain specified nodetype, this row will be excluded from presentation
Row 1 is link: Should this row be used as a link to the newsitem URLs specified in the RSS?
Class 1: Sets a value that defines a CSS class name to be used with the first row displayed for each news item.
Row2: Choose nodetype to display on this row. If news item does not contain specified nodetype, this row will be excluded from presentation
Row 2 is link: Should this row be used as a link to the newsitem URLs specified in the RSS?
Class 2: Sets a value that defines a CSS class name to be used with the second row displayed for each news item.
Row3: Choose nodetype to display on this row. If news item does not contain specified nodetype, this row will be excluded from presentation
Row 3 is link: Should this row be used as a link to the newsitem URLs specified in the RSS?
Class 3: Sets a value that defines a CSS class name to be used with the third row displayed for each news item.
Date formatting string: Sets a value that indicates how datetime values should be formatted. For a more information on the different date format strings see the DateTimeFormatInfo class documentation. The default value is an empty string which displays the system's date time format.
Size of alternate title.: Indicates the size of an alternative title when the source does not supply a title. The alternative title is automatically constructed from the first N characters of the description followed by ... For example: setting this property to 25 constucts an alternative title that consists of the first 25 characters in the description. The default value is zero which means that no alternative title is used.
Row colour 1: The background colour for each un-even row in the generated html table. This is set as a style attribute on the row element and can be overridden by CSS styling that applies directly to the cell.
Row colour 2: The background colour for each even row in the generated html table. This is set as a style attribute on the row element and can be overridden by CSS styling that applies directly to the cell.
Extra line feed: Insert an extra space between each displayed news item.
Use secure html formatting: Indicates whether the displayed result should be Html encoded or not.
WARNING!
This property should always be checked unless you really need otherwise and the source is highly trusted. Turning off this functionality can cause security problems with Html injections if the source contains active content.
Table formatting options
Table width: The width of the generated table. This value can be in percent (ex. 100%) or in pixels (ex. 340).
Table border size: Border or the generated table. Zero to omit the border.
Cell padding: The cell padding value (in pixels) used in the generated html table.
Cell spacing: The cell spacing value (in pixels) used in the generated html table.
Table summary: Sets the summary attribute of the generated table. A table summary is recommended for accessibility reasons and omitting this attribute causes xhtml 1.0 strict or higher validators to generate warning.
Table caption: Sets the caption element connected to the generated table. A table caption is recommended for accessibility reasons and omitting this element causes xhtml 1.0 strict or higher validators to generate warning.

The component does support HTML embedded into the RSS feed xml when you turn off the Use secure HTML formatting option off. If the source have embedded HTML the HTML content will appear as code in the result if this option is turned on, which is the default value.

For safety reasons you should only turn off Use secure HTML formatting for highly trusted web sites.

The Insert RSS Feed AS component

Summary

When to use

Programming interface

Parameters

Remarks